home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d1 / find211d.arc / FIND211.DOC next >
Text File  |  1990-04-02  |  14KB  |  376 lines
  1.                                    FIND.DOC
  2.  
  3.                                  March 25, 1990
  4.  
  5.  
  6.           Version 2.11 provides a tremendous gain in performance above
  7.           older versions of FIND, and other file finding programs.
  8.           FIND supports DOS 3.0 and higher.
  9.  
  10.           FIND supports the standard DOS drive, filename and wildcard
  11.           structure, but will not search a specific path.
  12.  
  13.  
  14.           Files:
  15.  
  16.               FIND211.DOC  - This file
  17.               FIND211.EXE  - Uses intelligent output display
  18.               FIND211.HST  - History file of changes to FIND by version
  19.               FIND211.HDR  - CompuServe file description header
  20.               SNAPSHOT.EXE - Capture disk sectors for bug reports
  21.  
  22.  
  23.           Enhancements:
  24.  
  25.               o  Speed
  26.               o  Color
  27.               o  Multiple drive search
  28.               o  Elapsed time
  29.               o  Exclusive hidden file search
  30.               o  Standard DOS display format
  31.               o  Intelligent output display
  32.               o  Support 80x43 and 132x43 screen sizes
  33.               o  EMS memory used when available
  34.               o  DOS 4 extended disk partition support
  35.               o  Dynamic data segment allocation
  36.               o  Debugging aid
  37.  
  38.  
  39.  
  40.           Speed:
  41.  
  42.               Version 2.11 is 450%  faster than FIND v1.x and 21% faster
  43.               than Whiz when searching for a single file name.  FIND
  44.               displays file names as they match the search spec, and will
  45.               slow down in proportion to the number of names that are
  46.               displayed.
  47.  
  48.  
  49.               Screen performance has been improved by utilizing direct
  50.               screen writes.  Snow prevention is implemented only when
  51.               the CGA card is detected.
  52.  
  53.  
  54.  
  55.           Color:
  56.  
  57.               FIND utilizes the colors that are found at the current cursor
  58.               position when the program starts.  The color preference of the
  59.               user is thus maintained.  Directories are displayed in the
  60.               inverse color of the text.  If text is white letters on a blue
  61.               background, the directories will be blue text in a white
  62.               background.  Subdirectory displays of high intensity colors are
  63.               modified so they do not blink.
  64.  
  65.               The banner colors are mostly low intensity for easy viewing.
  66.               Color selection was based on the best average values for LCD
  67.               laptops, monochrome, and color monitors.
  68.  
  69.  
  70.  
  71.           Multiple Drive Search:
  72.  
  73.               FIND will search multiple drives in ascending order starting
  74.               with the drive specified by the user.  If none is specified
  75.               then the first hard disk is assumed.
  76.  
  77.               Note that systems without a hard drive or ram disk MUST
  78.               always specify the drive letter.  FIND defaults to the
  79.               first drive after the last installed floppy disk.
  80.  
  81.  
  82.  
  83.           Single Drive Search:
  84.  
  85.               FIND will search a single drive if the /S switch is set.
  86.               This can be user-specified or the default drive.
  87.  
  88.  
  89.  
  90.           Hidden file search:
  91.  
  92.               The /H switch will display only hidden files that match
  93.               the search specification.  Hidden files are defined as
  94.               those files with the System or Hidden attribute bits set.
  95.  
  96.               The DOS kernel files, volume label, and other hidden files
  97.               will be displayed.
  98.  
  99.  
  100.  
  101.           Verbose path display:
  102.  
  103.               The /V switch will display all subdirectory paths as they
  104.               are scanned.  This may be used to create a listing of all
  105.               the subdirectories on the disk(s).  The drive letter and
  106.               path name are displayed on a single line in standard DOS
  107.               format.
  108.  
  109.               This is useful for building a list of all directories on
  110.               the disk(s), or debugging purposes.
  111.  
  112.  
  113.  
  114.           Screen pause:
  115.  
  116.               FIND will automatically pause when the screen is full.
  117.               This may be overridden by using the /N switch when FIND
  118.               is started.
  119.  
  120.               The banner will be scrolled off after the first pause,
  121.               and will no longer be visible.  This will allow more files
  122.               to be visible on each subsequent screen.
  123.  
  124.  
  125.  
  126.           Elapsed time:
  127.  
  128.               The total time taken to accomplish the search is displayed
  129.               with the matching files list.
  130.  
  131.  
  132.  
  133.           Standard DOS display format:
  134.  
  135.               The files that match the search parameter are displayed in
  136.               exactly the same format as used by the DOS Dir command.
  137.  
  138.               Appended to the standard DOS display format is the hex
  139.               value of the attribute byte and its meaning.
  140.  
  141.               Display clutter from long path names is eliminated by the
  142.               path name being displayed above the file name(s).  All
  143.               matching files in a given subdirectory are displayed under
  144.               the subdirectory name.  A new subdirectory name is double
  145.               spaced below the last file name displayed.
  146.  
  147.  
  148.  
  149.           Intelligent output display:
  150.  
  151.               FIND determines if DOS I/O redirection to a disk file or
  152.               printer is active.
  153.  
  154.               When redirection is active, all output is displayed a second
  155.               time using DOS.  All screen output except the author banners
  156.               are then output to the redirected device or file.
  157.  
  158.               For the screen, the color attribute found at the starting
  159.               cursor location is used.
  160.  
  161.               FIND automatically uses whichever video page number is
  162.               active at startup.  The user video configuration remains
  163.               unchanged.
  164.  
  165.  
  166.  
  167.           Long screen support:
  168.  
  169.               FIND uses the screen mode that is active at startup.
  170.               The 80x43 and 132x43 text screens are supported.
  171.               40 column mode is not supported.  FIND will continue to
  172.               run but all output beyond column 40 will not be seen.
  173.  
  174.  
  175.  
  176.           EMS memory support:
  177.  
  178.               4 pages of EMS memory, when available, is used for storing
  179.               the directory path table.  This reduces the required memory
  180.               by 64k bytes.
  181.  
  182.               FIND identifies the EMMXXXX0 device drive signature then
  183.               allocates EMS memory via DOS interrupt 67h with LIM 3.2
  184.               or higher.  The current context mapping is saved at entry
  185.               and is then restored when FIND terminates.
  186.  
  187.               FIND currently supports 512 directories, and an unlimited
  188.               amount of files.
  189.  
  190.               FIND can execute as a child process of a parent that uses
  191.               EMS memory without interfering with the parents' data.
  192.  
  193.  
  194.  
  195.           Extended disk partition support:
  196.  
  197.              FIND supports disk partitions greater than 32mb.
  198.              This feature was introduced in MS-DOS v3.2 and PC-DOS v4.0.
  199.  
  200.  
  201.  
  202.           Dynamic data segment allocation:
  203.  
  204.              Internal data segment sizes are allocated on the fly
  205.              for each logical drive that is searched.  Memory is
  206.              allocated in the exact amount required for each drive.
  207.  
  208.              Otherwise, memory would always have to be allocated
  209.              at 262k, the worst case condition.
  210.              Assume no EMS memory and extended disk partitions:
  211.  
  212.                     ■  128k FAT table
  213.                     ■   64k path table
  214.                     ■   64k directory data
  215.                     ■    6k code and stack space
  216.  
  217.              Reducing the minimum memory requirement allows FIND to more
  218.              easily run when a parent program 'shells out to DOS' and still
  219.              remains in memory.
  220.  
  221.  
  222.  
  223.           Debugging Aid:
  224.  
  225.               SNAPSHOT.EXE is a debug aid that captures the first 317k of
  226.               the specified disk boot sectors.  The captured data is then
  227.               written to a floppy disk in drive A: as SNAPSHOT.DAT.
  228.  
  229.               When I receive this disk and data, I can reassemble FIND
  230.               in debugging mode and run on the image of your disk.
  231.  
  232.               Caveats:  ALL user data within the 1st 317k of the disk will
  233.               be captured.  When I receive the SNAPSHOT dump, the user agrees
  234.               to release me from all liability associated with his data.
  235.  
  236.  
  237.  
  238.           PIF:
  239.  
  240.               FIND is 'ill behaved' in screen management functions
  241.               as direct screen writes are used.
  242.  
  243.               FIND is 'ill behaved' for vectors as it takes over 23h,
  244.               the Control-Break vector.
  245.  
  246.  
  247.  
  248.           Usage:
  249.  
  250.               Valid switches are /H, /S, /V:
  251.                    /H - hidden file(s)
  252.                         Only file attributes that match either the system
  253.                         or hidden bits will be displayed.
  254.  
  255.                    /S - single drive
  256.                         Only a single drive will be searched.
  257.                         If not specified, the default drive is assumed.
  258.                         Otherwise, the first file specified by the user
  259.                         is the only drive searched.
  260.  
  261.                    /V - verbose path display
  262.                         Every path searched will be displayed.
  263.                         Useful to build a complete path table of the
  264.                         specified drive(s) by searching for a non-existent
  265.                         file.  Also useful when FIND is used on a suspected
  266.                         incompatible DOS to see if legal paths are being
  267.                         searched.
  268.  
  269.  
  270.               FIND *.*
  271.                    Start with the default hard drive.
  272.                    Find all files.
  273.  
  274.               FIND *.* /H
  275.                    Start with the default hard drive.
  276.                    Find hidden files only.
  277.  
  278.               FIND *.* /V
  279.                    Start with the default hard drive.
  280.                    Display all paths as they are scanned.
  281.  
  282.               FIND *.* /H /S
  283.                    Start with the default hard drive.
  284.                    Find hidden files only.
  285.                    Check only the first hard drive.
  286.  
  287.               FIND A:*.*
  288.                    Start with the A: drive.
  289.                    Find all files.
  290.  
  291.               FIND A:*.* /S
  292.                    Start with the A: drive.
  293.                    Find all files.
  294.                    Check only the A: drive.
  295.  
  296.               FIND *.* /H /S > PRN
  297.                    Start with the default hard drive.
  298.                    Find hidden files only.
  299.                    Check only the first hard drive.
  300.                    Redirect output to printer.
  301.  
  302.               FIND *.* /H /S > C:\Temp\Dir.Lst
  303.                    Start with the default hard drive.
  304.                    Find hidden files only.
  305.                    Check only the first hard drive.
  306.                    Redirect output to disk file on drive C:
  307.  
  308.  
  309.  
  310.           Technical Data:
  311.  
  312.               FIND uses the BIOS Int 11h installed equipment call to
  313.               check the number of installed floppy disk drives.  If
  314.               a switch is set wrong, and this value is corrupted then
  315.               FIND will encounter errors trying to access the non-installed
  316.               drive.  Any floppy error causes that floppy to be bypassed.
  317.  
  318.               If the BIOS is set to 4 floppy drives (0..3), FIND will
  319.               assume the first hard drive to be device #4.  If the
  320.               system actually has only 2 floppies and a hard disk, FIND
  321.               will exit with no files found, because it starts searching
  322.               at drive #4 which does not exist.  Check your switch settings.
  323.  
  324.               FIND uses the DOS direct read interrupt Int25h.  The new
  325.               DOS 4 version deviates from earlier versions in the manner
  326.               that this interrupt is implemented.  FIND automatically uses
  327.               the extended partition calling convention for DOS 4 and up.
  328.  
  329.               FIND takes over one interrupt vector, Int23h (Control Break).
  330.               The control break allows the user to quit FIND at any point
  331.               during the execution.
  332.  
  333.               The vector is restored upon any exit from the program.
  334.  
  335.               A user entered ^C causes the program to terminate and restore
  336.               the ^C vector at exit.
  337.  
  338.               FIND performs direct reads of the disk and can not damage
  339.               the integrity of the disk.  No writes are done to the disk.
  340.  
  341.               There exists a naming conflict with a DOS program of the
  342.               same name.  FIND can be renamed to something else if the
  343.               DOS program is regularly used.  FIND can also be placed
  344.               in a path that comes before the DOS path.
  345.  
  346.               FIND is written entirely in Turbo Assembler v1.01.
  347.  
  348.  
  349.  
  350.           BUG Reports:
  351.  
  352.               Bug reports are graciously accepted.
  353.  
  354.               1)  Make/Version of DOS
  355.               2)  Copy of AUTOEXEC.BAT and CONFIG.SYS
  356.               3)  Names of TSRs if any, that are loaded
  357.               4)  Redirected copy of FIND in verbose mode.
  358.                   e.g.  FIND <nonexistent.file> /V > DUMP.FIL
  359.                   This provides a list of all subdirectories.
  360.               5)  Use SNAPSHOT to take a dump of the suspect disk.
  361.  
  362.               Attempt to diagnose any bugs by unloading all TSRs and
  363.               start with as simple a system as possible.
  364.  
  365.  
  366.  
  367.  
  368.  
  369.  
  370.           Please send a $10 registration to:
  371.  
  372.           Bruce Gavin
  373.           4730 Signal Rock Rd
  374.           Colorado Springs CO 80922-1623
  375.  
  376.           CompuServe: 70137,3244